home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / modst101.zip / MODSTATS.DOC < prev    next >
Text File  |  1997-05-25  |  11KB  |  220 lines

  1.                           MODEM STATS v1.01
  2.  
  3.               Rewritten for Supra modems by Simon Slater
  4.                           netmail 2:443/777
  5.                         e-mail coole@compura.com
  6. -------------------------------------------------------------------------
  7. MODEM STATS is a re-written STGEN for Supra Modems.
  8.  
  9. MODEM STATS consists of a single DOS EXE file,  called via a batch file
  10. with passed parameters and/or environment variables.   
  11.  
  12. Command line options for MODSTATS.EXE are as follows, all options are
  13. required, except the last three.
  14.  
  15. Usage:
  16.  
  17. MODSTATS  <port> <irq> <node> <esc char> <fossil> </NOXMIT>
  18.  
  19. port: COM port 1-4, FOSSIL port #, or non-standard base address.
  20.  
  21. irq: 0=default, or 1-15.  Not used in FOSSIL mode, set to 0.
  22.  
  23. node:  Current BBS node #, or 0 if single-node system.
  24.  
  25. esc char:   0-127, Value of the modem's S2 register, used to put the modem
  26.             into command mode.   If = 256, then modem uses &D1 setting, and
  27.             the door will toggle DTR to enter command mode.
  28.  
  29. fossil:  0=no FOSSIL, 1=use FOSSIL
  30.  
  31. /NOXMIT:  OPTIONAL; This will reverse the operation of the software from a BBS
  32.           DOOR to a mode that can be used with any comm program.  This option
  33.           prevents the software from trying to display anything out the
  34.           modem port.   Use this ONLY when calling from a comm program, do
  35.           NOT use this option when running as a BBS DOOR!
  36.  
  37. MODTMP: environment variable, path for report file
  38.  
  39.         ie
  40.  
  41.         SET MODTMP=E:\RA\TXTFILES
  42.  
  43.         Filename for report file is modemrpt.asc
  44.  
  45. --------------------------------------------------------------------------
  46.  
  47. SETUP EXAMPLE:
  48.  
  49. Here is an example of the DOOR batch file used for testing on my PCBoard
  50. system.   This batch file is hard-coded for COM2, IRQ3, node 1,
  51. DTR switching, FOSSIL enabled.
  52.  
  53. You obviously need to change all of this for your own system and setup, making
  54. use of environment variables and/or passed parameters where needed.
  55. (Like the node number on multi-node systems.)
  56.  
  57. REM ------------------------------
  58. REM TEST BATCH FILE FOR STGEN DOOR
  59. REM ------------------------------
  60. SET MODTMP=E:\RA\TXTFILES\
  61. MODSTATS 2 3 1 43 1 
  62.  
  63. --------------------------------------------------------------------
  64.  
  65. Using MODSTATS.EXE with RemoteAccess
  66.  
  67. This is an example of my system. your may slightly differ by most BBS software
  68. should be able to adapt this program for use with other BBS software.
  69.  
  70. 1. Put the All the files into your RA directory.
  71.  
  72. 2. make a entry in your menu where you want to called MODSTATS from.
  73.  
  74. like so..
  75.  
  76.  
  77. ╒══════════════════════════════════════════════════════════════ Edit Menu Item ╕
  78. │                                                                              │
  79. │          1         2         3         4         5         6         7       │
  80. │ 123456789012345678901234567890123456789012345678901234567890123456789012345  │
  81. │ ;                                                                            │
  82. │                                                                              │
  83. │ MODSTATS                                                                     │
  84. │                                                                              │
  85. │ Action   Goto another menu (Type 1)                                          │
  86. │ Display                                                                      │
  87. │ OptData                                                                      │
  88. │ HotKey   *                                                                   │
  89. │ AutoExec No                                                                  │
  90. │ Colour   Colour example                                                      │
  91. │                                                                              │
  92. │ MinSec   0                  TimeUsed 0                  FlatCost 0           │
  93. │ MaxSec   0                  TimeLeft 0                  TimeCost 0           │
  94. │ A flags  --------           Age      0                  Terminal Any         │
  95. │ B flags  --------           MinSpeed 0                  Nodes                │
  96. │ C flags  --------           MaxSpeed 0                  Groups               │
  97. │ D flags  --------           Credit   0                  DayTimes             │
  98. │                                                                              │
  99. │                                                                              │
  100. ╘══════════════════════════════════════════════════════════════════════════════╛
  101.  
  102. Then create a new menu called MODSTATS like so:
  103.  
  104. ╒════════════════════════════════════════════════════ E:\RA\MENUS\MODSTATS.MNU ╕
  105. │                          │***│ Execute    │ *C /C e:\ra\modem.bat *M         │
  106. │                          │***│ Disp CR    │ MODSTATS                         │
  107. │                          │***│ Clear/Goto │ MAINMENU                         │
  108. │                                                                              │
  109. ╘══════════════════════════════════════════════════════════════════════════════╛
  110.  
  111. keep these commands in this order.
  112.  
  113. 1.
  114. ╒══════════════════════════════════════════════════════════════ Edit Menu Item ╕
  115. │                                                                              │
  116. │          1         2         3         4         5         6         7       │
  117. │ 123456789012345678901234567890123456789012345678901234567890123456789012345  │
  118. │ ;                                                                            │
  119. │                                                                              │
  120. │ *C /C e:\ra\modem.bat *M                                                     │
  121. │                                                                              │
  122. │ Action   Execute sub-program (Type 7)                                        │
  123. │ Display                                                                      │
  124. │ OptData                                                                      │
  125. │ HotKey                                                                       │
  126. │ AutoExec Yes                                                                 │
  127. │ Colour   Colour example                                                      │
  128. │                                                                              │
  129. ╘══════════════════════════════════════════════════════════════════════════════╛
  130.  
  131. The Autoexec is set to yes so that the program is all automated from running the
  132. program and then showing the user the report.
  133.  
  134. 2.
  135. ╒══════════════════════════════════════════════════════════════ Edit Menu Item ╕
  136. │                                                                              │
  137. │          1         2         3         4         5         6         7       │
  138. │ 123456789012345678901234567890123456789012345678901234567890123456789012345  │
  139. │ ;                                                                            │
  140. │                                                                              │
  141. │ MODSTATS                                                                     │
  142. │                                                                              │
  143. │ Action   Display .ANS/.ASC with CR pause at end (Type 45)                    │
  144. │ Display                                                                      │
  145. │ OptData                                                                      │
  146. │ HotKey                                                                       │
  147. │ AutoExec Yes                                                                 │
  148. │ Colour   Colour example                                                      │
  149. │                                                                              │
  150. ╘══════════════════════════════════════════════════════════════════════════════╛
  151.  
  152. The last command is used to return to the last menu
  153. ╒══════════════════════════════════════════════════════════════ Edit Menu Item ╕
  154. │                                                                              │
  155. │          1         2         3         4         5         6         7       │
  156. │ 123456789012345678901234567890123456789012345678901234567890123456789012345  │
  157. │ ;                                                                            │
  158. │                                                                              │
  159. │ MAINMENU                                                                     │
  160. │                                                                              │
  161. │ Action   Clear gosubs & goto menu (Type 4)                                   │
  162. │ Display                                                                      │
  163. │ OptData                                                                      │
  164. │ HotKey                                                                       │
  165. │ AutoExec Yes                                                                 │
  166. │ Colour   Colour example                                                      │
  167. │                                                                              │
  168. ╘══════════════════════════════════════════════════════════════════════════════╛
  169.  
  170. NOTE: The MODSTATS.MNU for RA is included in the archive.
  171.  
  172. OK now for the BATCH file.
  173.  
  174. */ (MODEM.BAT)
  175. @echo off
  176. del e:\ra\txtfiles\modstats.*   (deletes and old reports first)
  177. SET MODTMP=E:\RA\TXTFILES\      (sets the directory for the report) 
  178. MODSTATS 2 3 1 43 1             (com2, irq3, node1, esc43 (+), use fossil)
  179.  
  180. CD \RA\TXTFILES\                (Now change to RA txtfiles directories)
  181. MODSTANS                        (convert modstas.asc to an ansi screen
  182.                                 (using ASC2ANS.EXE)
  183. CD \RA                          (change back to RA directory) 
  184. /*
  185.  
  186. MODSTANS is included in the MODSTANS.RAR Archive
  187.  
  188. Well thats about it..
  189.  
  190. The REPORT.TXT shows exactly what the report is like.
  191.  
  192. NOTE to Other Rockwell users.
  193.  
  194. MODSTATS is purely for Supra Modems due to the commands given by the
  195. MODSTATS executable.
  196.  
  197. If there is any commands that you need changed or added please netmail me
  198. and I'll do the necessary and send you a revised copy.
  199.  
  200. -------------------------------------------------------------------------
  201. My thanks go to all users that tested this program to the full on my BBS.
  202.  
  203. Also many thanks to the author of:
  204.  
  205. STGEN V1.08  -  12/30/95
  206. Written by Joseph C. Frankiewicz
  207. The Majestik Moose BBS  708-843-2871
  208. Released to the public domain.
  209. and the STGEN.BAS file!!!!
  210.  
  211. STGEN is a generic "Door" version of USRSTATS that should work with
  212. *or without* a FOSSIL driver, with DTR *or escape character* switching,
  213. at speeds up to 115.2K, under virtually any BBS *OR COMM* package,
  214. automatically multi-node-aware.
  215.  
  216. And also the really nice ansi creator MODSTANS created by Hans A. Mahal
  217. Thanks Hans!
  218.  
  219. [EOF]
  220.